home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / gwa281v1.zip / README < prev    next >
Text File  |  1997-07-03  |  15KB  |  339 lines
  1. === GW-Angband Information ===
  2.  
  3. GW-Angband is a variant of Angband.  For some details, see the online help
  4. files.  For more details, see "http://kellnet.com/wooledge/angband.html".
  5. Bug reports for GW-Angband should be sent to the author, Greg Wooledge, at
  6. "wooledge@kellnet.com".
  7.  
  8. GW-Angband 2.8.1 is a re-application of the GW-Angband changes to the
  9. Angband 2.8.1 code base.  This means that you will be able to enjoy the
  10. many wonderful features that Ben Harrison has added to Angband recently.
  11. There are also a very small number of little bug fixes & changes.
  12.  
  13. === Angband Information ===
  14.  
  15. === GW-Angband Information ===
  16.  
  17. GW-Angband is a variant of Angband.  For some details, see the online help
  18. files.  For more details, see "http://kellnet.com/wooledge/angband.html".
  19. Bug reports for GW-Angband should be sent to the author, Greg Wooledge, at
  20. "wooledge@kellnet.com".
  21.  
  22. GW-Angband 2.8.1 is a re-application of the GW-Angband changes to the
  23. Angband 2.8.1 code base.  This means that you will be able to enjoy the
  24. many wonderful features that Ben Harrison has added to Angband recently.
  25. There are also a very small number of little bug fixes & changes.
  26.  
  27. === Angband Information ===
  28.  
  29. === GW-Angband Information ===
  30.  
  31. GW-Angband is a variant of Angband.  For some details, see the online help
  32. files.  For more details, see "http://kellnet.com/wooledge/angband.html".
  33. Bug reports for GW-Angband should be sent to the author, Greg Wooledge, at
  34. "wooledge@kellnet.com".
  35.  
  36. GW-Angband 2.8.1 is a re-application of the GW-Angband changes to the
  37. Angband 2.8.1 code base.  This means that you will be able to enjoy the
  38. many wonderful features that Ben Harrison has added to Angband recently.
  39. There are also a very small number of little bug fixes & changes.
  40.  
  41. === Angband Information ===
  42.  
  43. === GW-Angband Information ===
  44.  
  45. GW-Angband is a variant of Angband.  For some details, see the online help
  46. files.  For more details, see "http://kellnet.com/wooledge/angband.html".
  47. Bug reports for GW-Angband should be sent to the author, Greg Wooledge, at
  48. "wooledge@kellnet.com".
  49.  
  50. GW-Angband 2.8.1 is a re-application of the GW-Angband changes to the
  51. Angband 2.8.1 code base.  This means that you will be able to enjoy the
  52. many wonderful features that Ben Harrison has added to Angband recently.
  53. There are also a very small number of little bug fixes & changes.
  54.  
  55. === Angband Information ===
  56.  
  57. === GW-Angband Information ===
  58.  
  59. GW-Angband is a variant of Angband.  For some details, see the online help
  60. files.  For more details, see "http://kellnet.com/wooledge/angband.html".
  61. Bug reports for GW-Angband should be sent to the author, Greg Wooledge, at
  62. "wooledge@kellnet.com".
  63.  
  64. GW-Angband 2.8.1 is a re-application of the GW-Angband changes to the
  65. Angband 2.8.1 code base.  This means that you will be able to enjoy the
  66. many wonderful features that Ben Harrison has added to Angband recently.
  67. There are also a very small number of little bug fixes & changes.
  68.  
  69. === Angband Information ===
  70.  
  71. This is the README file for Angband 2.8.1 (03/04/97)
  72.  
  73. Angband 2.8.1 is a semi-stable official release incorporating all of the
  74. improvements added since Angband 2.7.8.  Any bugs found in Angband 2.8.1
  75. will be fixed in Angband 2.8.2, the next stable official release.
  76.  
  77. See the Official Angband Home Page "http://www.voicenet.com/~benh/Angband/"
  78. for more information about exactly what has changed recently.
  79.  
  80. === General information ===
  81.  
  82. Angband is a "graphical" dungeon adventure game using textual characters
  83. to represent the walls and floors of a dungeon and the inhabitants therein,
  84. in the vein of "rogue", "hack", "nethack", and "moria".
  85.  
  86. There are extensive ascii "on line help" files in the "lib/help" directory.
  87.  
  88. This version of Angband will run on Macintosh, Windows, Unix (X11/Curses), 
  89. Linux (X11/Curses), Acorn, Amiga, various IBM machines, and many others...
  90.  
  91. See Makefile, h-config.h, and config.h for details on compiling.
  92. See "Makefile.xxx" and "main-xxx.c" for various supported systems.
  93.  
  94. Visit the Angband Home Page ("http://www.voicenet.com/~benh/Angband/"),
  95. and browse through the Angband newsgroup ("rec.games.roguelike.angband").
  96.  
  97. Send bug reports, suggestions, etc, to Ben Harrison ("benh@voicenet.com").
  98.  
  99.  
  100. === Quick and dirty compilation instructions (for Unix) === 
  101.  
  102. Step 1: Acquire.  Ftp to "export.andrew.cmu.edu:/angband/Source"
  103.                   Try "bin" and "mget angband*.tar.gz" and "y"
  104. Step 2: Extract.  Try "gunzip *.gz" then "tar -xvf *.tar"
  105. Step 3: Prepare.  Try "cd angband*/src", then edit "Makefile"
  106.                   You may also edit "h-config.h" and "config.h"
  107. Step 4: Compile.  Try "make", and then "cd .." if successful
  108. Step 5: Execute.  Try "angband -uTest" to initialize stuff
  109. Step 6: Play....  Read the "online help" via the "?" command.
  110.  
  111.  
  112. === Special instructions for other systems ===
  113.  
  114. The IBM requires extraction with "pkunzip -d" to create subdirectories.
  115.  
  116. The Macintosh requires that the "lib" folder be in the same folder as
  117. the executable.  Also, note that System 7.5 (and perhaps others) are
  118. brain damaged, and may default to the incorrect folder for opening
  119. savefiles.  Make sure you keep all your savefiles in the proper place,
  120. and if you load a savefile from the wrong place, note that the game
  121. may decide to re-save your savefile in the proper place when you quit.
  122.  
  123.  
  124. === Upgrading from older versions or other platforms ===
  125.  
  126. If you have been playing Angband on a different platform, or with an older
  127. version of Angband, it may be possible to "upgrade" to Angband 2.8.X, keeping
  128. your old savefiles, high score list, and other files, instead of starting over.
  129.  
  130. Angband 2.8.X uses a platform independant file format for the binary files
  131. that store information about games in progress, known as "savefiles".  Also,
  132. Angband 2.8.X is able to translate savefiles from any version of Angband from
  133. Angband 2.5.1 on.  Unfortunately, pre-2.5.1 savefiles are not usable, since
  134. they used a system specific savefile format, and did not have an official
  135. definition, and sometimes include assumptions that are no longer valid.  To
  136. use an old savefile, simply copy it into the "lib/save" directory, changing
  137. the name of the savefile (if necessary) to satisfy the requirements of the
  138. platform you are using.  In general, the savefile should be named "UUU.NNN"
  139. or "NNN" where "UUU" is the userid of the player (on "multiuser" systems),
  140. and "NNN" is the name of the "character" in the savefile.  Note that only
  141. "multiuser" platforms use the "UUU.NNN" form, and the "period" is required.
  142.  
  143. Angband 2.8.X uses a platform independant (?) file format for the binary
  144. file used to store the high score list.  This file may be moved between
  145. platforms (if needed) or copied from older versions (Angband 2.7.4 or later).
  146. Angband 2.8.X uses a high score file called "scores.raw", which is kept in
  147. the "lib/apex" directory.  Older versions kept the "scores.raw" file in the
  148. "lib/data" directory, along with several other version specific files.
  149.  
  150. Angband 2.8.X uses a platform independant file format for the ascii files
  151. used to store information about dead players, which is used to help create
  152. "player ghosts" in the dungeon.  If necessary, these files, which are kept
  153. in the "lib/bone" directory, may be copied from older versions, as long as
  154. you make sure that they are renamed as "bone.XXX" where XXX is the level on
  155. which the dead player died, and that every line in the file is "complete".
  156. It is also possible to delete the contents of the "lib/bone" directory at
  157. any time, which will prevent the creation of player ghosts.  Currently,
  158. these files are not actually used by the game.
  159.  
  160. Angband 2.8.X uses a set of ascii "configuration files" which are kept in the
  161. "lib/file" directory (see below).  Certain of these files may be taken from
  162. older versions, though most are optional for the most common configurations.
  163.  
  164. Angband 2.8.X uses a set of ascii "user pref files" which are kept in the
  165. "lib/user" directory.  Some of these files are usable on multiple platforms,
  166. but in general they are restricted to a single platform.  In general, "pref"
  167. files from older versions may be used with Angband 2.8.X, by moving them to
  168. the "lib/user" directory from the old "lib/pref" or "lib/pref-*" directories,
  169. but note that some important changes have been made in Angband 2.8.X, and, for
  170. example, old "pref" files which change the "attr/char" definitions of "terrain"
  171. features such as walls or doors must be changed to use the new methods.  Make
  172. sure to put comments in your "user pref files" describing the purpose and the
  173. proper platform for your files, to facilitate future upgrades.
  174.  
  175.  
  176. === Directory "src" ===
  177.  
  178. The "src" directory contains the complete set of source files.
  179.  
  180. The "main-???.c" and "Makefile.???" allow compilation on various systems.
  181.  
  182. Some of these systems (Macintosh, Windows) require "extra" files, most of
  183. which are located elsewhere (except for the "A-mac-h.*" Macintosh files).
  184.  
  185.  
  186. === Directory "lib" ===
  187.  
  188. The "lib" directory contains all of Angband's special sub-directories.
  189.  
  190.  
  191. === Directory "lib/apex" ===
  192.  
  193. The "lib/apex" directory contains the "high score" files.
  194.  
  195. The "scores.raw" file contains the "high score" table, in a "semi-binary" form,
  196. that is, all the bytes in the file are normal ascii values, but this includes
  197. the special "nul" or "zero" byte, which is used to separate and pad records.
  198. You should probably not attempt to modify this file with a normal text editor.
  199. This file should be (more or less) portable between different platforms.  It
  200. must be present (or creatable) for the game to run correctly.
  201.  
  202.  
  203. === Directory "lib/bone" ===
  204.  
  205. The "lib/bone" directory contains special "player ghost" template files.
  206.  
  207. The files in this directory have filenames of the form "bone.NNN" where
  208. "NNN" is the level on which the player died.  They contain information
  209. about the dead player, currently, one line each for the player name,
  210. maximum hitpoints, race, and class.  These files are probably portable,
  211. and are probably compatible with older bone files, if those files are
  212. renamed, and a final newline is added for compatibility.  Actually,
  213. only the "player name" from these files is actually used.
  214.  
  215.  
  216. === Directory "lib/data" ===
  217.  
  218. The "lib/data" directory contains various special binary data files.
  219.  
  220. The files 'f_info.raw', 'k_info.raw', 'a_info.raw', 'e_info.raw', 'r_info.raw',
  221. and 'v_info.raw' are binary image files constructed by parsing the ascii
  222. template files in "lib/edit", described below.  These files are required,
  223. but can be created by the game if the "lib/edit" directory contains the
  224. proper files, and if the game was compiled to allow this creation.
  225.  
  226.  
  227. === Directory "lib/edit" ===
  228.  
  229. The "lib/edit" directory contains various special ascii data files.
  230.  
  231. The files 'f_info.txt', 'k_info.txt', 'a_info.txt', 'e_info.txt', 'r_info.txt',
  232. and 'v_info.txt' are ascii template files used to construct the binary image
  233. files in "lib/data", described above.  These files describe the "terrain
  234. features", "object kinds", "artifacts", "ego-items", "monster races", and
  235. "dungeon vaults", respectively.
  236.  
  237. The ascii template files are easier to edit than hard-coded arrays, and also
  238. prevent compilation errors on some machines, and also shrink the size of the
  239. binary executable, and also provide a user-readible spoiler file of sorts.
  240.  
  241. These files are optional if the game is distributed with pre-created
  242. binary raw files in "lib/data".
  243.  
  244.  
  245. === Directory "lib/file" ===
  246.  
  247. The "lib/file" directory contains various special ascii data files.
  248.  
  249. The 'news.txt' file is displayed to the user when the game starts up.  It
  250. contains basic information such as my name and email address, and the names
  251. of some of the people who have been responsible for previous versions of
  252. Angband.  You may edit this file (slightly) to include local "site specific"
  253. information such as who compiled the local executable.  You should refer the
  254. user to a special "online help" file, if necessary, that describes any local
  255. modifications in detail.  The first two lines of this file should be blank,
  256. and only the next 20 lines should contain information.
  257.  
  258. The 'dead.txt' file is displayed to the user when the player dies.  It
  259. contains a picture of a tombstone which is filled in with interesting
  260. information about the dead player.  You should not edit this file.
  261.  
  262. The optional file 'wizards.txt' may be used to specify which users may enter
  263. 'wizard' mode.  A missing file provides no restrictions, and an empty file
  264. prevents everyone from entering 'wizard' mode.  This file is only used on
  265. multi-user machines, otherwise there are no restrictions.
  266.  
  267. The optional file 'time.txt' may be used to restrict the "times" at which
  268. the game may be played, by providing specification of which hours of each day
  269. of the week are legal for playing the game.  See 'files.c' for more details.
  270. A missing file provides no restrictions, and an empty file will, by default,
  271. forbid the playing of the game from 8am-5pm on weekdays.  This file is only
  272. used on multi-user machines, and only if CHECK_TIME is defined, otherwise,
  273. there are no restrictions.
  274.  
  275. The optional file 'load.txt' may be used to restrict the "load" which the game
  276. may impose on the system.  See 'files.c' for more details.  A missing file
  277. provides no restrictions, and an empty file will, by default, restrict the
  278. "current load" to a maximal value of 100*FSCALE.  This file is only used on
  279. multi-user machines, and only if CHECK_LOAD is defined, otherwise, there are
  280. no restrictions.
  281.  
  282.  
  283. === Directory "lib/help" ===
  284.  
  285. The "lib/help" directory contains the "online help" files.
  286.  
  287. This directory is used to search for normal "on line help" files.
  288.  
  289.  
  290. === Directory "lib/info" ===
  291.  
  292. The "lib/info" directory (optional) contains the "spoiler" files.
  293.  
  294. This directory is used to search for any "on line help" file that cannot
  295. be found in the "lib/help" directory.
  296.  
  297. The user may "redirect" this directory to point at any available directory.
  298.  
  299. Note that the default "help.hlp" file allows the "9" key to access a help
  300. file called "spoiler.hlp", and allows the "0" key to access "user.hlp".
  301.  
  302. These special help files can thus be placed in the user's own "info"
  303. directory to allow the on line help to access his files.
  304.  
  305.  
  306. === Directory "lib/save" ===
  307.  
  308. The "lib/save" directory contains "savefiles" for the players.
  309.  
  310. Each savefile is named "NNN" where "NNN" is the name of the savefile, or,
  311. on some machines, the name of the character, or, on multi-user machines,
  312. "UUU.NNN", where "UUU" is the player uid and "NNN" is the savefile name.
  313.  
  314. The savefiles should be portable between systems, assuming that the
  315. appropriate renaming is perfomed, and any file "type" information is
  316. specified (for the Macintosh).
  317.  
  318.  
  319. === Directory "lib/user" ===
  320.  
  321. The "lib/user" directory contains the "user pref files", if any.
  322.  
  323. In general, these files are used to "customize" aspects of the game for
  324. a given site or a given player.  These files can define "macros" (which
  325. allow a single keypress to perform a complex action), set options (which
  326. affect how the game will handle various situations), and specify visual
  327. mappings for various monsters, objects, or terrain features.
  328.  
  329. See "files.c" for more information on the proper "format" of these files.
  330.  
  331.  
  332. === Directory "lib/xtra" ===
  333.  
  334. The "lib/xtra" directory contains special system files, if any.
  335.  
  336.  
  337. --- Ben ---
  338.  
  339.